home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / thot11.zip / THOUGHT.DOC < prev    next >
Text File  |  1992-11-30  |  22KB  |  662 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                          ─┬─ ╖ ┌ ╓─┐ ╖ ┌ ╓─┐ ╖ ┌ ─┬─
  11.                           │  ╟─┤ ║ │ ║ │ ║ ┬ ╟─┤  │
  12.                           ┴  ╜ └ ╙─┘ ╙─┘ ╙─┘ ╜ └  ┴
  13.  
  14.                                    ╓─┐ ╓──
  15.                                    ║ │ ╟─
  16.                                    ╙─┘ ╨
  17.  
  18.                                  ─┬─ ╖ ┌ ╥─┐
  19.                                   │  ╟─┤ ╟─
  20.                                   ┴  ╜ └ ╨─┘
  21.  
  22.                                  ╥─┐ ╓─┐ ╖ ┐
  23.                                  ║ │ ╟─┤ ╙─┤
  24.                                  ╨─┘ ╜ └ ──┘
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                             The BBS Ponder Point
  31.  
  32.  
  33.                                  version 1.1
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                               by Michael Wilson
  49.  
  50.                                  The Village
  51.                                 408-229-0706
  52.                         USR Courier HST Dual Standard
  53.                             1200/2400/9600/16.8K
  54.                               24 hours / 7 days
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                                 CONTENTS
  61.                                 ════════
  62.  
  63.    I.   Introduction
  64.         a. Overview
  65.         b. Background
  66.         c. Tools
  67.         d. Restrictions in the unregistered version
  68.         e. Benefits of registering
  69.         f. Support
  70.  
  71.    II.  The Configuration File
  72.         a. Execution of the program
  73.         b. Multi-Node operation
  74.  
  75.    III. Customization
  76.         a. THOUGHT.DAT
  77.         b. HEADER.ANS and HEADER.ASC
  78.         c. FOOTER.ANS and FOOTER.ASC
  79.  
  80.    IV.  Random Thoughts
  81.         a. Sample Data files
  82.  
  83.    V.   Compufax Software
  84.  
  85.    VI.  Registration Information and Form
  86.  
  87.    VII. Bug report form
  88.  
  89.    VIII.Revision History
  90.  
  91.  
  92.  
  93.  
  94.                               INTRODUCTION
  95.                               ════════════
  96.  
  97. Overview
  98. ────────
  99.  
  100.    Thought of the Day is a utility that will create an ANSI color and ASCII
  101.    non-color bulletin or hello screen for a BBS, network system, autoexec
  102.    file, or most any other application.  It will read sequentially through a
  103.    "quotes" file, and create a 3D color file, and a plain non-color file.
  104.    The color file will have its frame color rotated with each execution of
  105.    the program.  Thought of the Day has the following features:
  106.  
  107.      * Quotes file is plain text, and can be added to or edited
  108.      * You create the header and footer lines
  109.      * Support ANSI color header file
  110.  
  111. Background
  112. ──────────
  113.  
  114.    The idea for this utility came from David Clifford of the Haunted Castle
  115.    BBS.  He desired a utility that would display and rotate advertisements
  116.    for doors and little used features of his Bulletin Board.  This utility,
  117.    however can display any text, of nearly unlimited lines to your callers,
  118.    for any purpose.
  119.  
  120. Tools
  121. ─────
  122.  
  123.         Language and Compiler:  Borland C 3.1
  124.  
  125.         Editor:                 Multi-Edit 6.10aP
  126.  
  127.         Version Control:        Sage's PVCS
  128.  
  129.         Beta Test:              The Haunted Castle BBS (Spitfire)
  130.                                     408-226-1052
  131.                                 The Village (Wildcat)
  132.                                     408-229-0706
  133.  
  134.         Tea:                    Earl Grey, Hot (Bigelow)
  135.  
  136.  
  137.  
  138.  
  139. Restrictions in the unregistered version
  140. ────────────────────────────────────────
  141.  
  142.    This utility will be fully functional in the unregistered version to give
  143.    you a chance to try it out for as long as you wish before purchasing or
  144.    deleting it from your system.  However, the following restrictions apply:
  145.         1. An unregistered notice is tagged on to the end of the created
  146.            files
  147.         2. Usage of the keyword FILE and use of HEADER.* and FOOTER.* is not
  148.            permitted.
  149.  
  150. Benefits of registering
  151. ───────────────────────
  152.  
  153.    1. All delays and reminders are removed.
  154.  
  155.    2. All future updates FREE, downloaded from The Village BBS.
  156.  
  157.    3. Ability to use the keyword FILE and HEADER.* and FOOTER.*
  158.  
  159. Support
  160. ───────
  161.  
  162.    Snail-Mail:  Compufax Consulting Services
  163.                 7145 Aptos Beach Court
  164.                 San Jose, CA  95139
  165.  
  166.    BBS:   The Village
  167.           408-229-0706
  168.           USR Courier HST Dual Standard 16.8k
  169.           Leave comment for the SYSOP in the Main Conference [000]
  170.  
  171.    Voice Mail:  408-496-9045  (24 hours/day)
  172.  
  173.    CompuServe:  76207,1673
  174.  
  175.  
  176.    Please include all available information including copies of your
  177.    THOUGHT.CFG files.
  178.  
  179.  
  180.    The latest version will always be available on the following boards:
  181.  
  182.         The Village:
  183.                 408-229-0706
  184.                 USR Courier HST Dual Standard 16.8k
  185.                 Michael Wilson, sysop
  186.  
  187.         The Haunted Castle BBS:
  188.                 408-226-1052
  189.                 USR Courier HST Dual Standard 14.4k
  190.                 David Clifford, sysop
  191.  
  192.         CompuServe:  IBM BBS Forum (GO IBMBBS), Doors Library
  193.  
  194.  
  195.  
  196.                              CONFIGURATION FILE
  197.                              ══════════════════
  198.  
  199.    THOUGHT knows what type of system you are using, and what to do
  200.    through a configuration file.  The configuration file can have any legal
  201.    DOS filename.  It consists of 11 lines as follows:
  202.  
  203.    line 1:     The Village
  204.    line 2:     Michael Wilson
  205.    line 3:     0000000000
  206.    line 5:     And now a word from your sponsor
  207.    line 6:     Now, on with the show
  208.    line 7:     thought.dat
  209.    line 8:     HELLO3.SCR
  210.    line 9:     HELLO3.BBS
  211.    line 10:    YES
  212.    line 11:    0
  213.    line 12:    1
  214.  
  215.    NOTE: The line numbers are only listed for clarity.  Your configuration
  216.    file will have no line numbers listed
  217.  
  218.    LINE 1: This is the complete drive letter, path and filename of your
  219.            BBS door system file.  This can be either DOOR.SYS,
  220.            CALLINFO.BBS or PCBOARD.SYS.
  221.  
  222.    LINE 2: This is the name of your BBS.  It must EXACTLY match the name
  223.            of the BBS you put on the registration form.  Upper and lower
  224.            case make a difference here.  This name will be displayed
  225.            EXACTLY as entered here when the door is registered.
  226.  
  227.    LINE 3: This is the name of the sysop.  This name must EXACTLY match
  228.            the name entered on the registration form.  Upper and lower
  229.            case make a difference.  This name will be displayed as the
  230.            sysop when the door is registered.
  231.  
  232.    LINE 4: The registration number obtained when you register.
  233.  
  234.    LINE 5: This is the opening remark that is displayed to your callers
  235.            before they see the Thought for the day.  In the registered
  236.            version, you can use the keyword FILE here.  If you do, then the
  237.            contents of the files HEADER.ANS and HEADER.ASC will be used for
  238.            the opening statement.
  239.  
  240.  
  241.  
  242.    LINE 6: This is the closing remark displayed to your callers right after
  243.            the Thought for the day.  In the registered version, you can use
  244.            the keyword FILE here.  If you do, then the contents of the files
  245.            FOOTER.ANS and FOOTER.ASC will be used as your closing statement.
  246.  
  247.    LINE 7: This is the complete drive/path/filename of your Thought for the
  248.            Day file.
  249.  
  250.    LINE 8: This is the complete drive/path/filename of the ANSI color output
  251.            file.
  252.  
  253.    LINE 9: This is the complete drive/path/filename of the ASCII non-color
  254.            output file.
  255.  
  256.    LINE 10: YES or NO.  This tells Thought is you want to automatically
  257.             center each line in the window.  YES centers the lines, NO does
  258.             not center the lines.
  259.  
  260.    LINE 11: This needs to be 0.  It is a counter for the program, and will be
  261.             changed each time you run the program, but must start as a 0 the
  262.             first time you run the program.
  263.  
  264.    LINE 12: This needs to be 1.  This is a counter for the program, and will
  265.             be changed each time you run the program, but must start as a 1
  266.             the first time you run the program.
  267.  
  268.  
  269. Program Execution
  270. ─────────────────
  271.  
  272.    To make Thought of the Day do what it was written to do, do this:
  273.  
  274.         THOUGHT THOUGHT.CFG
  275.  
  276.    You, of course, can call your config file anything you want, but that is
  277.    the basic idea.  Run it once, and see if the bulletins were created, and
  278.    what they look like, then either tell me what needs to improve, or
  279.    register!
  280.  
  281.    Wildcat sysops can put Thought in their POSTCALL.BAT, or in a nightly
  282.    event.  It depends on how often you want the THOUGHT to change.
  283.  
  284.  
  285.  
  286.                                 CUSTOMIZATION
  287.                                 ═════════════
  288.  
  289. THOUGHT.DAT
  290. ───────────
  291.  
  292.    You may call your quotes data file anything you want, and specify the name
  293.    on line 7 of your config file.  For the purpose of this explanation,
  294.    however, I shall call the data file THOUGHT.DAT.
  295.  
  296.    THOUGHT.DAT is a text file that contains the text displayed by Thought of
  297.    the Day.  The format is:
  298.  
  299.         line
  300.         line
  301.         line
  302.         space
  303.         line
  304.         space
  305.         line
  306.         line
  307.         space
  308.         line
  309.  
  310.    Thought of the Day will read all lines until it reaches a blank line.  It
  311.    will consider that the end of the quote.  The next time it is run, it will
  312.    take the next quote until a blank line is found.  Quotes can be as many
  313.    lines long as you want.
  314.  
  315.    Each line cannot be more than 45 characters long.  If you wish to center
  316.    your lines on the screen, you need to add spaces in from of the line.
  317.    Experimenting with your added quote lines is the best way to see how they
  318.    will be displayed.
  319.  
  320.    Any line beginning with a semi-colon (;) is a comment, and ignored.
  321.  
  322. HEADER.ANS and HEADER.ASC
  323. ─────────────────────────
  324.  
  325.    In the registered version, you can enter the keyword FILE on line 5 of the
  326.    configuration file.  If this word is found, the file HEADER.ANS will be
  327.    place before the quote text in the color bulletin, and HEADER.ASC will be
  328.    used in the non-color bulletin.  The file is put there in its entirety,
  329.    including special BBS control codes, clear screen command, etc.  You can
  330.    draw a picture with THEDRAW, and have it displayed before each quote.
  331.  
  332. FOOTER.ANS and FOOTER.ASC
  333. ─────────────────────────
  334.  
  335.    Footer files work the same way as Header files, except that they are
  336.    displayed after the quote.
  337.  
  338.  
  339.  
  340. Multi-Node Operation
  341. ────────────────────
  342.  
  343.    If Thought is running on a multi-node system, you must load share.  This
  344.    will prevent Thought from reading and writing the same bulletin at the
  345.    same time.
  346.  
  347.  
  348.  
  349.  
  350.                                RANDOM THOUGHTS
  351.                                ═══════════════
  352.  
  353.    The purpose of Thought is for you to make a set of announcements or
  354.    encouragements for your callers, and display them in a colorful way.  The
  355.    initial concept was not for a large data file of several hundred quotes to
  356.    be displayed to callers as random bits of wisdom.  However, Thought of the
  357.    Day could easily be used for that purpose.  Wildcat Quotes.bbs files use
  358.    the same format as this program, but their line length is usually too
  359.    long.  Modification of these files, therefore, could give your BBS a quote
  360.    for the day, if it does not already have one.
  361.  
  362.    If you create a rather lengthy or clever THOUGHT.DAT file, upload it to
  363.    me.  With your permission, I'll begin including such files as part of the
  364.    release zip file.
  365.  
  366.    With this, the initial release, I include a sample of a THOUGHT.DAT just
  367.    so you get the idea.  This file is not designed to be used on your board,
  368.    but you may if you wish.
  369.  
  370. Sample Data files
  371. ─────────────────
  372.  
  373.    The following Thought for The Day data files are included for you use:
  374.  
  375.       LAWS4U.TXT: Some common sense, and funny laws
  376.  
  377.       SMTOWN.TXT: Ways to know that your from a small town
  378.  
  379.       BADDAY.TXT: How you know your having a bad day
  380.  
  381.    Replace line 7 of your config file with the name of any one of these
  382.    files to try them out.
  383.  
  384.  
  385.  
  386.                               COMPUFAX SOFTWARE
  387.                               ═════════════════
  388.  
  389.    Compufax Software is a division of Compufax Consulting Services.  We
  390.    specialize in getting the right computer and software for your needs.  All
  391.    of our work is custom and created just for you.
  392.  
  393.    We started writing door software with a program called BUY&SELL Door.
  394.    After reviewing dozens of For Sale Doors, we could not find one to meet our
  395.    needs, so we wrote one.  That is what we do.  We find a need, and write a
  396.    door to fill that.  You won't find us writing 30 card game doors that all
  397.    look the same.  Each door is individually designed to meet a need.
  398.    Currently, we have 5 BBS door programs:
  399.  
  400.         Food Fight
  401.         Buy & Sell
  402.         UNIPAGE
  403.         QDMENU
  404.         THOUGHT of the Day
  405.  
  406.    We will not cripple our doors.  We'll just put in a few seconds reminder
  407.    that this copy is unregistered.  We will never write a door that expires.
  408.    We have over 60 doors on our board, and sometimes it is month before a
  409.    door is fully tested.  We won't force you to download a demo key every few
  410.    weeks either.  Everything you need for full operation of our doors is
  411.    included in the distribution zip.  No runtime modules, no keys, nothing
  412.    extra, nothing more to download.
  413.  
  414.    All of our doors have a simple to use Local mode.  You can see the program
  415.    before you put it online.
  416.  
  417.    Your registrations are forever.  When we give you a registration number,
  418.    you will never need to buy anything ever again.  Each new version will use
  419.    the same number, and you're registered for life.
  420.  
  421.    You can receive free technical support even if you are not a registered
  422.    user.  Because of my schedule, I cannot be available for voice support,
  423.    but I'll answer every message on my BBS and Compuserve.  If you need to
  424.    talk to me voice, I'll be happy to make an appointment and call you.
  425.  
  426.    We're tired of poorly programmed, boring BBS Doors.  We are here to change
  427.    all that.  We may not have 30 doors, but the few we have are the best!
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.                                 REGISTRATION
  444.                                 ════════════
  445.  
  446.      When you register THOUGHT, your registration number will be posted on
  447.      The Village BBS (408-229-0706), in a private message to you.  You
  448.      should allow 1 week from the time you send your check before the
  449.      message is posted.  Other options include sending you the number and
  450.      sending you the latest version of the program with the number.
  451.      NOTE: The latest version may not be later than the one you have, and no
  452.      version number verification will be performed..
  453.  
  454.  
  455.  
  456.  
  457.  
  458.                         THOUGHT REGISTRATION FORM
  459.                         ═════════════════════════
  460.  
  461.      Your BBS Number (so I can call and see):_________________
  462.  
  463.  
  464.      Name: ___________________________________________________
  465.  
  466.            (Your name here must match EXACTLY with the name entered
  467.             on line 3 of the config file.  Upper and lower case make a
  468.             difference here.  Print or type clearly.)
  469.  
  470.  
  471.      BBS Name: _______________________________________________
  472.  
  473.                (Your BBS name here must match EXACTLY with the BBS name
  474.                entered on line 2 of the config file.  Upper and lower case
  475.                make a difference here.  Print or type clearly.)
  476.                If this is not run on a BBS, enter your company name or the
  477.                word NONE in all capital letters.
  478.  
  479.  
  480.      The name you have used or wish to use to log into The Village BBS:
  481.  
  482.      _________________________________________________________________
  483.  
  484.  
  485.       ╔════════════════════════════════════════════════════════════╗
  486.       ║                                                            ║
  487.       ║ If you do not have a login to my board, and wish me to set ║
  488.       ║ one up for you, supply the following information:          ║
  489.       ║                                                            ║
  490.       ║                                                            ║
  491.       ║ Phone number (with area code): __________________________  ║
  492.       ║                                                            ║
  493.       ║ Birthday: _______________________________________________  ║
  494.       ║                                                            ║
  495.       ║ Password: _______________________________________________  ║
  496.       ║                                                            ║
  497.       ╚════════════════════════════════════════════════════════════╝
  498.  
  499.  
  500.      If you wish me to send you the registration number of the latest
  501.      version of THOUGHT, fill out the following:
  502.  
  503.  
  504.      Address:____________________________________________________
  505.  
  506.              ____________________________________________________
  507.  
  508.              ____________________________________________________
  509.  
  510.  
  511.  
  512.      Mail To:  Compufax Consulting Services
  513.                7145 Aptos Beach Court
  514.                San Jose, CA  95139
  515.  
  516.      Select which option you would like to register THOUGHT:
  517.  
  518.  
  519.      Basic Registration.
  520.        Includes lifetime registration number posted
  521.        to The Village BBS in a private message to you....$10.00 _____
  522.  
  523.  
  524.      Mail Number.
  525.        Includes lifetime registration number mailed
  526.        to you at the above address.......................$12.50 _____
  527.  
  528.  
  529.      Mail Diskette.
  530.        Includes lifetime registration number mailed
  531.        to on a diskette, along with the latest version
  532.        of this software..................................$17.00 _____
  533.  
  534.           Type of diskette: *5.25" High Density _____
  535.                              5.25" Low Density  _____
  536.                             *3.5"  High Density _____
  537.                              3.5"  Low Density  _____
  538.  
  539.         *If you choose a High Density diskette, you will get
  540.          sample of other Compufax Software on the same disk
  541.  
  542.                                            Total Enclosed: __________
  543.  
  544.       Payment method:
  545.  
  546.       [  ] Check made payable to Compufax Consulting Services.
  547.  
  548.       [  ] VISA   [  ] Master Card   [  ] Discover   [  ] Carte Blanche
  549.  
  550.       [  ] JCB    [  ] Diner's Club
  551.  
  552.  
  553.     For Credit Card Purchases:
  554.  
  555.       Number:________________________________Ex Date:_________________
  556.  
  557.       Name on card:___________________________________________________
  558.  
  559.       Statement ______________________________________________________
  560.         Mailing
  561.         Address:______________________________________________________
  562.  
  563.                 ______________________________________________________
  564.  
  565.       Home Phone:_____________________ Work Phone:____________________
  566.  
  567.  
  568.       Signature:______________________________________________________
  569.  
  570.  
  571.  
  572.  
  573.  
  574.                         R E G I S T E R   O N L I N E
  575.                         ═════════════════════════════
  576.  
  577.     You can register this software On-Line on the Village BBS.  From the main
  578.     menu, Choose [Q]uestionnaires, and choose questionnaire number 6.  Have
  579.     your charge card ready.
  580.  
  581.     We accept VISA, Master Card, Discover, Diner's Club, Carte Blanche and
  582.     JCB cards.
  583.  
  584.     Due to the nature of your purchase, your registration number will be
  585.     available within 12 hours of you completing the questionnaire.
  586.  
  587.  
  588.  
  589.                                  BUG REPORT
  590.                                  ══════════
  591.  
  592.     Please report any and all bugs to my.  Include as much information as you
  593.     can.  If I think I have fixed it, I will send you the new version
  594.     for free, for testing.
  595.  
  596.     You may use the form below to report any bugs, or use your own form.
  597.     Please send the form to me, or upload it to my BBS.
  598.  
  599.     Explain the bug:____________________________________________________
  600.  
  601.     ____________________________________________________________________
  602.  
  603.     ____________________________________________________________________
  604.  
  605.     ____________________________________________________________________
  606.  
  607.     ____________________________________________________________________
  608.  
  609.     ____________________________________________________________________
  610.  
  611.     ____________________________________________________________________
  612.  
  613.     ____________________________________________________________________
  614.  
  615.     ____________________________________________________________________
  616.  
  617.     ____________________________________________________________________
  618.  
  619.     ____________________________________________________________________
  620.  
  621.     ____________________________________________________________________
  622.  
  623.     ____________________________________________________________________
  624.  
  625.     (use another sheet of paper if needed)
  626.  
  627.     Your BBS number:____________________________________________________
  628.  
  629.     Version of THOUGHT:________________________________________________
  630.  
  631.     DOS Date and time of THOUGHT.EXE:__________________________________
  632.  
  633.     BBS Software and version:___________________________________________
  634.  
  635.     Describe your machine:______________________________________________
  636.  
  637.     ____________________________________________________________________
  638.  
  639.     Describe your multi-tasking, if any:________________________________
  640.  
  641.     ____________________________________________________________________
  642.  
  643.     Is this multi-node? (how many)______________________________________
  644.  
  645.     Please include copies of your THOUGHT.CFG, and THOUGHT.DAT.
  646.  
  647.  
  648.  
  649.                               REVISION HISTORY
  650.                               ════════════════
  651.  
  652.     November 25, 1992    Version 1.0
  653.         Initial Release
  654.  
  655.     November 30, 1992    Version 1.1
  656.         Fixed a hang if the destination file does not exit
  657.  
  658.  
  659.  
  660.  
  661.  
  662.